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INTRODUCTION: 

ED is a command for editing 14-word BCD card image files within CTSS. The 
command on TYPSET (CC-244, MAC-M-193 by J. H 0 Saltzer) and many of the conventions 
ot TYPSET are used by ED. Tabs are automatically interpreted for FAR, MAD, MADTRN, 
and ALG0L(i.e. , AED) programs. Tabs may also be set by the user for other purposes. 
Although line numbers may be generated by the ED command, editing is done entirely 
by context. The ED command is offered as an alternate to the present INPUT, EDIT 
and FILE command s Q 

USAGE: 

The ED command is initiated with the following CTSS command. 

ED PNAME CLASS 

CLASS is the secondary name of the file to be edited or created and must always 
be provided. PNAME is the primary name of the file to be edited. If PNAME is 
not specified, ED will assume that a new file is to be created and will start 
the user in the high-speed INPUT mode. If PNAME is provided, the command will 
assume that the file "PNAME CLASS" is to be edited and the user will be started 
in the EDIT mode. 

HIGH-SPEED INPUT MODE: 

When the user enters this mode, the ED command will type "INPUT" on the 
user's console. While the user is operating in this mode, the ED command will 
accept input lines from the user's console. Tabs will be interpreted automatically 
for each input line. Backspace characters may also be used to move back one 
character position in the input line. No response is typed for input lines and 
as a result, the user may type successive lines as fast as he wishes. When the 
user types a line consisting only of a single carriage return, the ED command 
will place the user's console in the EDIT mode. 

EDIT MODE: 


When the user enters this mode response "EDIT" will be typed on the user's 



console. At this time the user may type requests to the ED command. All changes 
to a file become effective immdeiately and as a result, the user is able to make 
recursive modifications to his file. Conceptually we may think of a pointer 
which is positioned at a line in the edited file. When the user enters the EDIT 
inode from the INPUT mode, thLs pointer will be positioned at the last input line 
typed by the user. When the user starts the ED command in the EDIT mode, the 
pointer is positioned before the first line in the old file. If the end of file 
is reached by an EDIT request, the comment "END OF FILE REACHED BY 11 is typed on 
the user 1 s console followed by the request which caused the end of file to be 
reached. At this time the pointer will be positioned after the last line in the 
file. When in the EDIT mode, any line which is not a legitimate EDIT request 
will cause the comment "NOT A REQUEST" to be typed on the user ! s console followed 
by the line which caused the error. In many cases it is possible for the user 
to stack EDIT requests. If one of the requests causes an error message to be 
typed, any stacked requests will be ignored. This is done in case one of the 
stacked requests depended on the successful completion of the request in error. 


EDIT REQUESTS : 

FIND LINE 
F 

none 

END OF FILE 


REQUEST: 
ABBREVIATION: 
RESPONSE: 
ERRORS : 


The FIND request is used to move the pointer forward from its present 
position to the line specified by LINE. LINE is a normal input line and may 
contain tabs and backspaces. This line is used as a mask for selecting the 
desired line in the edited file. Matching is done only on the non-blank 
characters specified in LINE. For example, the request, 


F (tab) -(tab) -ALPHA, 1 
might be used to find the line. 


LOOP TIX 

REQUEST: 

ABBREVIATION: 

RESPONSE: 

ERRORS: 


ALPHA, 1,4 
LOCATE string 
L 

none 

END OF FILE 


The LOCATE request is used to move the pointer forward from its present 
position to the first line which contains the entire character string specified 
by "string". The full line of 84 characters is scanned, so that "string" may 
specify line numbers. It is recommended that "string" include the leading zeros 
of the line numbers to avoid any undesired match with program constants. 


REQUEST: 
ABBREVIATION: 
RESPONSE: 
ERRORS : 


NEXT 1 
N 

none 

END OF FILE 


This request is used to move the pointer forward from its present position 
in the file. "1" specifies the number of lines to be skipped over. If 1 is 
"0" or not specified, it is assumed to be "1" and the pointer will be moved to 
the next line in the file. If the NEXT request is given after the end of file 



has been reached, the pointer will be reset to the beginning of the file 
and moved "1" lines from there, 

REQUEST: DELETE 1 

ABBREVIATION D * 

RESPONSE: none 

ERRORS: END OF FILE 

The DELETE request will delete ,f l ff lines from the file starting with 
the line at which the pointer is curently positioned. The pointer is left 
at the position vacated by the last line deleted by this request. If 1 is 
"0" or left unspecified, only the current line will be deleted. 

REQUEST: PRINT 1 L 

ABBREVIATION: P 

RESPONSE: printed lines 

ERRORS: END OF FILE 

The PRINT request will print "l" lines from the file starting with the 
line at which the pointer is currently positioned. Upon completion of this 
request, the pointer will be left pointing to the last line printed. If 1 
is ,? 0 n or left unspecified, one line will be printed. Normally lines are 
printed without line numbers. If the character n L n is present in the PRINT 
request, line numbers will be printed to the right of the printed lines. 

REQUEST: RETYPE LINE 

ABBREVIATION: R 

RESPONSE: none 

ERRORS: none 

This request will cause the line at which the pointer is currently 
positioned to be replaced by LINE. LINE is a normal input line and may 
contain tabs and backspaces. The pointer is not moved by this request. 


REQUEST: TOP 

ABBREVIATION: T 

RESPONSE: none 

ERRORS : none 


This request will cause the pointer to be reset and positioned before 
the first line in the file. 


REQUEST: BOTTOM 

ABBREVIATION: B 

RESPONSE: INPUT 

ERRORS: none 


This request will cause the pointer to be positioned after the last 
card in the file. Upon completion of this request the user's console will be 
placed in the high-speed INPUT mode. All subsequent lines will be treated 
as input and added to the end of the file. 

REQUEST: INSERT 

ABBREVIATION: I 

RESPONSE: INPUT 

ERRORS: 


none 



This request will cause the user r s console to be placed in the 
high-speed INPUT mode. All subsequent lines will be treated as input 
and inserted after the line at which the pointer is currently positioned. 

If the INSERT request is given immediately following a TOP request, the 
inserted lines will be placed at the beginning of the file. 

REQUEST: CHANGE QstringlQstring2Q 1 G 

ABBREVIATION: C 

RESPONSE: none 

ERRORS: END OF FILE 

This request will examine "l" lines starting at the line at which the 
pointer is currently positioned. Upon completion, the pointer will be left 
positioned at the last line examined by this requesto If 1 is n 0 M or left 
unspecified, it is assumed to be n l n and only the current line will be 
examined. The character f, Q lf is taken to be the delineator or !, Quote 
character 11 and may be any character in the 6-bit BCD set. "stringl" and 
,f string2 ,! are arbitrary BCD character strings and may be of different 
lengths. If the character n G n (GLOBAL) is present, every occurrence of 
stringl will be replaced by string2. If lf G n is not present, only the first 
occurence of stringl will be replaced by string2 in each examined line. 
EXAMPLES: 

1 ine : ALPHA= ALPHA+ALPHA 

request: C f ALPHA' BETA r 

new line: BETA= ALPHA+ALPHA 

request: C r ALPHA T DELTA r 1 G 

new line: BETA= DELTA+DELTA 

request: C T DELTA+ fl 

new line: BETA= DELTA 

REQUEST: VERIFY 

ABBREVIATION: none 

RESPONSE: none 

ERRORS: none 

The VERIFY request sets the verify mode. In the verify mode, the 
requests FIND, NEXT, LOCATE, and CHANGE, will cause the printing of the 
current-pointer line. In addition, CHANGE will cause the printing of all 
changed lines. Requests may not be stacked while in the verify mode. 


REQUEST: BRIEF 

ABBREVIATION: none 

RESPONSE: none 

ERRORS : none 


The BRIEF request sets the brief or normal mode. Within the brief 
mode, the FIND, NEXT, LOCATE and CHANGE requests will give no response. 

REQUEST: SERIAL N 

ABBREVIATION: S 

RESPONSE: none 

ERRORS : none 

This request is used to change the increment between line numbers of 



successive lines to the increment specified by the decimal integer "N". 

Initially, this increment is set to 10 by the ED command. If N is "0" or 
not specified, it is assumed to be ,! 10 M . Lines inserted after a line with 
the line number "L" will be sequenced L+N, L+2N, L+3N, etc. If the lines 
following the inserted lines have numbers which are less than or equal to 
the line number of the last inserted line, as many lines as necessary will 
be resequenced to insure that all line numbers are unique and in ascending 
order. For example, assume that "N" is 2 and the user wishes to insert 9 
lines after line 25 in a file that was previously sequenced by fives. The 
inserted lines would be numbered, 27, 29, 31 • 43. The lines previously 

numbered, 30, 35, 40, 45 and 50 would ne renumbered to 45 , 47, 49, 51 and 
53 respectively. The remaining lines in the file would be unchanged. 


REQUEST: 

ABBREVIATION: 

RESPONSE: 

ERRORS: 


TABSET Tl T2 . . . TN 

none 

none 

ILLEGAL TAB SETTING 


Ti specify the columns at which tabs are to be set. Tabs must be set 
in ascending order and may not exceed column 84. 


REQUEST: 
ABBREVIATION: 
RESPONSE: 
ERRORS : 


FILE NAME 
none 

Ready message from CTSS 
NO FILE NAME GIVEN 


This request is used to terminate the editing process and write the 
new edited file on the disk. NAME specifies the primary name of the new 
file to be created. If NAME is not specified, the old file will be replaced 
by the edited file. If no name was given by the initial ED command or by 
the FILE request, an error message will be printed and the FILE request will 
be ignored. 
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